home *** CD-ROM | disk | FTP | other *** search
/ BCI NET 2 / BCI NET 2.iso / archives / networking / misc / parpc04.lha / packet / docs / INSTALL.DOC < prev    next >
Encoding:
Text File  |  1993-08-13  |  9.1 KB  |  255 lines
  1.                              August 12, 1993
  2.  
  3.  
  4.  
  5.  
  6.           Installation instructions for the packet driver collection
  7.           (Currently only for PARnet & SLIP)
  8.  
  9.  
  10.           Document conventions
  11.           
  12.                All numbers in this document are given in C-style
  13.           representation.  Decimal is expressed as 11, hexadecimal is
  14.           expressed as 0x0B, octal is expressed as 013.  All reference to
  15.           network hardware addresses (source, destination and multicast)
  16.           and demultiplexing information for the packet headers assumes
  17.           they are represented as they would be in a MAC-level packet
  18.           header being passed to the send_pkt() function.
  19.           
  20.           
  21.           Using the packet drivers
  22.           
  23.                The packet driver must be installed prior to use.  Since
  24.           each packet driver takes only a few thousand bytes, this is best
  25.           done in your autoexec.bat.  Since the Ethernet boards typically
  26.           have jumpers on board, the packet driver must be informed of the
  27.           values of these jumpers (auto-configure is possible, but can
  28.           disturb other boards).  The first parameter is the software
  29.           interrupt used to communicate with the packet driver.  And
  30.           again, because each board is different, the rest of the
  31.           parameters will be different.
  32.           
  33.           All parameters must be specified in C-style representation.
  34.           Decimal is expressed as 11, hexadecimal is expressed as 0x0B,
  35.           octal is expressed as 013.  Any numbers that the packet driver
  36.           prints will be in the same notation.
  37.           
  38.           Before installing the packet driver, you must choose a software
  39.           interrupt number in the range between 0x60 and 0x80.  Some of
  40.           these interrupts are used for other purposes, so your first
  41.           choice may not work.  See Appendix A for the section of Ralf
  42.           Brown's interrupt list between 0x60 and 0x80.
  43.           
  44.           Running a packet driver with no specifications will give a
  45.           usage message.  The parameters for each packet driver are
  46.           documented below.
  47.           
  48.           Most drivers can also be used in a PROM boot environment, see
  49.           PROMBOOT.NOT for how to use -d and -n options for that purpose.
  50.           
  51.           The -w switch is used for Windows.  Install the packet driver
  52.           before running MS-Windows.  This switch does not prevent Windows
  53.           from swapping your network application out of memory, it simply
  54.           detects when that has happened, and drops the packets on the
  55.           floor.
  56.           
  57.           PARNET
  58.  
  59.                usage: PARNET [-n] [-d] [-w] <packet_int_no> <int_level>
  60.           <io_addr> <netaddr>
  61.          
  62.                The PARNET driver is an Ethernet adapter simulation for
  63.           PARnet-PC. PARNET-PC is a direct port from the Amiga's PARnet
  64.           PARnet which enables a multi-host network on one parallel line.
  65.           However, since not all parallel (printer) cards don't support
  66.           bi-directional pulled-up centronic cable, you must have a PARnet
  67.           INTERFACE. A description of this interface is given in the
  68.           PARPCXX.ZIP file in which XX represents the version number.
  69.  
  70.           The parameters are as follows. The INT_LEVEL is the hardware IRQ
  71.           on which your parallel card is connected. In 99% of the cases
  72.           this is IRQ7 (enter: 7). The IO_ADDR is the portaddress of the
  73.           card, in standard configurations this is 0x378 (LPT1) or 0x278
  74.           (LPT2). The NETADDR is the PARnet address of this interface, this
  75.           is an unique number for each interface. You can choose any number
  76.           inbetween 0x01 and 0xfe (1 to 254 decimal). NOTE: When sending IP
  77.           packets, the driver uses the last octet in the IP addresses to
  78.           reach other hosts. So when you already have a fixed IP address for
  79.           your machine, let NETADDR be the last number. (e.g. when you have
  80.           the address 193.79.1.2, the NETADDR MUST be 2! ).
  81.                                ^                      ^
  82.  
  83.  
  84.           SLIP8250
  85.           
  86.                usage: SLIP8250 [-n] [-d] [-w] packet_int_no [-h]
  87.           [driver_class] [int_no]
  88.                   [io_addr] [baud_rate] [recv_buf_size]
  89.                   The driver_class should be SLIP, KISS, AX.25, or a
  90.                   number.
  91.           
  92.                The SLIP8250 driver is not strictly an Ethernet adapter,
  93.           however some software packages (such as KA9Q's NET and NCSA
  94.           Telnet) support Serial Line IP (SLIP).  SLIP must be specially
  95.           supported because it doesn't use ARP and has no hardware
  96.           addresses prepended to its packets.  The PDS is not clear on
  97.           this, but the packet driver does the SLIP encoding.
  98.           
  99.           The parameters are as follows.  The -h flag is included if you
  100.           wish to use hardware handshaking (the packet driver will then
  101.           suspend the transmission of characters while CTS is low).  The
  102.           driver_class is the class that is returned to a client of the
  103.           packet driver spec in the driver_info call.  The int_no is the
  104.           hardware interrupt number, defaults to 4 (COM1).  The io_addr
  105.           is the hardware I/O address, defaults to 0x3f8 (COM1).  The
  106.           baud_rate defaults to 4800 baud.  The recv_buf_size defaults to
  107.           3000.
  108.           Errorlevels
  109.           
  110.                Some of the packet drivers return error codes.  Some of
  111.           these error codes indicate fatal errors, and some are merely
  112.           warnings.  For the moment, you must consult the source to see
  113.           what the errorcodes mean.  For example, pktchk returns 0 if a
  114.           packet driver exists at a given address, and 1 if not.  You
  115.           might use it in a batch file that only installs a packet driver
  116.           if one is not found.
  117.           
  118.                   rem only install the packet driver if there isn't one
  119.                   rem already.
  120.                   pktchk 0x7e
  121.                   if errorlevel 0 goto gotit
  122.                   ni5210 0x7e
  123.           
  124.           :gotit
  125.           
  126.                The "errorlevel" test is true if the errorlevel is less
  127.           than or equal to the parameter.
  128.           
  129.  
  130.                                      Appendix A
  131.           
  132.           Interrupt usage in the range 0x60 through 0x80, from Ralf
  133.           Brown's interrupt list.
  134.           
  135.                    
  136.                    
  137.           60 -- -- reserved for user interrupt 
  138.           60 -- -- FTP Driver - PC/TCP Packet Driver Specification 
  139.           60 01 FF FTP Driver - DRIVER INFO 
  140.           60 02 -- FTP Driver - ACCESS TYPE 
  141.           60 03 -- FTP Driver - RELEASE TYPE 
  142.           60 04 -- FTP Driver - SEND PACKET 
  143.           60 05 -- FTP Driver - TERMINATE DRIVER FOR HANDLE 
  144.           60 06 -- FTP Driver - GET ADDRESS 
  145.           60 07 -- FTP Driver - RESET INTERFACE 
  146.           60 11 -- 10-NET - LOCK AND WAIT 
  147.           60 12 -- 10-NET - LOCK 
  148.           60 13 -- 10-NET - UNLOCK 
  149.           60 20 -- FTP Driver - SET RECEIVE MODE 
  150.           60 21 -- FTP Driver - GET RECEIVE MODE 
  151.           60 24 -- FTP Driver - GET STATISTICS 
  152.           61 -- -- reserved for user interrupt 
  153.           62 -- -- reserved for user interrupt 
  154.           63 -- -- reserved for user interrupt 
  155.           64 -- -- reserved for user interrupt 
  156.           65 -- -- reserved for user interrupt 
  157.           66 -- -- reserved for user interrupt 
  158.           67 -- -- LIM EMS 
  159.                    ...  
  160.           67 DE 00 Virtual Control Program Interface - INSTALLATION CHECK 
  161.                    ...  
  162.           68 01 -- APPC/PC 
  163.                    ...  
  164.           69 -- -- unused 
  165.           6A -- -- unused 
  166.           6B -- -- unused 
  167.           6C -- -- system resume vector (CONVERTIBLE) 
  168.           6C -- -- DOS 3.2 Realtime Clock update 
  169.           6D -- -- VGA - internal 
  170.           6E -- -- unused 
  171.           6F -- -- Novell NetWare - PCOX API (3270 PC terminal interface) 
  172.           6F 00 -- 10-NET - LOGIN 
  173.                    ...  
  174.           70 -- -- IRQ8 - AT/XT286/PS50+ - REAL-TIME CLOCK 
  175.           71 -- -- IRQ9 - AT/XT286/PS50+ - LAN ADAPTER 1 
  176.           72 -- -- IRQ10 - AT/XT286/PS50+ - RESERVED 
  177.           73 -- -- IRQ11 - AT/XT286/PS50+ - RESERVED 
  178.           74 -- -- IRQ12 - PS50+ - MOUSE INTERRUPT 
  179.           75 -- -- IRQ13 - AT/XT286/PS50+ - 80287 ERROR 
  180.           76 -- -- IRQ14 - AT/XT286/PS50+ - FIXED DISK 
  181.           77 -- -- IRQ15 - AT/XT286/PS50+ - RESERVED 
  182.           78 -- -- not used 
  183.           79 -- -- not used 
  184.           7A -- -- Novell NetWare - LOW-LEVEL API 
  185.           7A -- -- AutoCAD Device Interface 
  186.           7B -- -- not used 
  187.           7C -- -- not used 
  188.           7D -- -- not used 
  189.           7E -- -- not used 
  190.  
  191.  
  192.  
  193.  
  194.  
  195.  
  196.           7F -- -- HDILOAD.EXE - 8514/A VIDEO CONTROLLER INTERFACE 
  197.           7F -- -- HLLAPI (High-Level Language API) 
  198.           80 -- -- reserved for BASIC
  199.  
  200.  
  201.  
  202.  
  203.  
  204.  
  205.  
  206.  
  207.  
  208.  
  209.  
  210.  
  211.  
  212.  
  213.  
  214.  
  215.  
  216.  
  217.  
  218.  
  219.  
  220.  
  221.  
  222.  
  223.  
  224.  
  225.  
  226.  
  227.  
  228.  
  229.  
  230.  
  231.  
  232.  
  233.  
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.